cs-credits-sapi icon

cs-credits-sapi

(0 reviews)

📚 Data Dictionary - CS Credits System API (SAPI)

This section provides the meaning of the attributes included in the API.


🗂️ Base Information


🔑 API KEYS

  • "Authorization": "Bearer {{API_KEY}}"Attribute defined in the request Header.

    • Type: String
    • Length: Minimum 36 characters, maximum 37 characters
    • Description: Authentication token required to access the API.
  • "client_id": "{{CLIENT_ID}}"Attribute defined in the request Header.

    • Type: String
    • Length: Minimum 32 characters, maximum 36 characters
    • Description: Unique client identifier to authenticate the request.

NOTE: It is important to have these API KEYS to make any request to our services.


📄 Check Status (POST /subscriptions/check-status)

  • "idRequest"

    • Type: Number
    • Description: Unique identifier for the credit insurance request.
    • Example: 255025
  • "status"

    • Type: String
    • Description: The current status of the credit insurance.
    • Allowed Values: pending, approved, rejected

✏️ Update Status (PUT /subscriptions/{idRequest})

  • "idRequest"

    • Type: Number
    • Description: Unique identifier for the credit insurance request (path parameter).
    • Example: 255025
  • "status"

    • Type: String
    • Description: New status to be updated for the request.
    • Allowed Values: pending, approved, rejected
  • "comments"

    • Type: String
    • Description: Optional comments regarding the status update.
    • Max Length: 250 characters

🗂️ Common Parameters

ParameterTypeDescriptionRequired
client_idstringUnique identifier for API clients
AuthorizationstringBearer token for secure access
idRequestnumberUnique ID for credit insurance request
statusstringStatus of the insurance request✅ (for PUT requests)
commentsstringAdditional notes or remarksOptional

🔐 Security Schemes

Client ID Enforcement

FieldTypeRequiredLength (characters)RegEx
client_idStringYes32 - 36[a-zA-Z0-9]
client_secretStringYes32 - 64[a-zA-Z0-9]

OAuth 2.0

FieldTypeRequiredLength (characters)RegEx
AuthorizationStringYes36 - 37[a-zA-Z0-9-_.]

⚠️ Common Error Codes

CodeDescriptionSuggested Solution
400Bad RequestVerify the request structure.
401UnauthorizedCheck the authentication credentials.
404Not FoundEnsure the endpoint is correct.
500Internal Server ErrorTry again later or contact support.

📞 Support

For any questions or issues, please contact the API support team COORDINACION DESARROLLO DE SERVICIOS Y APLICACIONES DE INTEGRACIONES.

Notes

  • Documentation adjusted in February 2025.
  • For additional information, contact: epalma@fgs.co

Reviews